home *** CD-ROM | disk | FTP | other *** search
/ The Original Shareware 1.1 / The Original Shareware (WeMake CDs)(Volume 1.1)(CDs, Inc)(1993).iso / 8 / hdtst484.zip / FIXFAT.DOC < prev    next >
Text File  |  1989-11-10  |  7KB  |  126 lines
  1.           
  2.           Documentation for FIXFAT                Copyright 1989, P. R. Fletcher          _________________________              _______________________________
  3.           
  4.           
  5.                                        INTRODUCTION                                       ____________
  6.  
  7.           FIXFAT is part of the HDTEST package, and is currently only
  8.           distributed with that software. The program and documentation may only
  9.           be used or copied as part of the HDTEST package. The program allows
  10.           DOS's two on-disk copies of the FAT to be made to correspond, when
  11.           they have got "out of sync". This is required for HDCHEK and HDTEST to
  12.           run. FIXFAT is only intended to be used when something has happened to
  13.           corrupt or alter one copy of the FAT (usually because the second copy                           ___                                                 
  14.           was only partially updated when a disk write was immediately followed
  15.           by a reboot or use of the "big red switch"). The program cannot repair
  16.           the FAT if both copies have become corrupted, nor is it intended to be
  17.           a replacement for CHKDSK or the more complex disk repair utilities
  18.           that are supplied with (e.g.) the Norton and Mace Utilities (TM).
  19.           Users who have, and are comfortable with, the latter utilities will
  20.           probably find FIXFAT superfluous. It is intended to provide a simple,
  21.           limited, but fairly safe way for less experienced users to correct
  22.           minor FAT problems prior to running HDTEST.
  23.  
  24.           FIXFAT is Copyright by Peter R. Fletcher, 1989. All rights are
  25.           reserved. It was largely written in C, compiled with the Microsoft C
  26.           compiler (V5.1). A few low-level functions were written in assembly
  27.           language and assembled with the Microsoft MASM assembler (V5.1). The
  28.           program was linked with code from the Microsoft C function libraries
  29.           by means of the Microsoft LINK linker (V4.06). It consequently
  30.           contains material that is Copyright by Microsoft Corp, 1985-1988. This
  31.           material is used under the terms of a license from Microsoft Corp.
  32.  
  33.  
  34.                                      USING THE PROGRAM                                     _________________
  35.  
  36.           You should generally run CHKDSK before running FIXFAT, unless you have                                          ______                                
  37.           some good reason to believe that the primary copy (and only the                                                            _____________
  38.           primary copy of the FAT on your disk (FAT 1) has been corrupted. If          ____________                                                       
  39.           CHKDSK reports any problems other than "orphan clusters", you should,
  40.           if possible, also back up any irreplaceable files on the disk before
  41.           either using CHKDSK with its /F option or running FIXFAT. If both your
  42.           FATs have been damaged (e.g. by a defective program writing junk to
  43.           the FAT area), neither CHKDSK nor FIXFAT will be able to help you, and
  44.           your only hope is to use a disk repair utility such as those provided
  45.           with the Mace or Norton Utilities (TM).
  46.  
  47.           The command line syntax for FIXFAT is:
  48.  
  49.                         FIXFAT dev[:]
  50.  
  51.           "dev" is the single letter DOS device identifier for the device whose
  52.           FAT is to be fixed - the colon is optional. FIXFAT will first read and
  53.           compare the two copies of the FAT on the target disk. If they are
  54.           identical, this fact will be reported and the program will terminate.
  55.           If there are any discrepancies between the two copies of the FAT, the
  56.           program will examine them individually for evidence of corruption. If
  57.           FAT 1 appears valid, you will be prompted for permission to overwrite
  58.           FAT 2 with a copy of FAT 1. If FAT 1 appears invalid but FAT 2 appears                                                       __                       
  59.           valid, you will similarly be prompted for permission to overwrite FAT
  60.           1 with a copy of FAT 2. If neither FAT appears valid, this will be
  61.           reported and the program will terminate. In determining whether a copy
  62.            
  63.           Documentation for FIXFAT                Copyright 1989, P. R. Fletcher          _________________________              _______________________________
  64.           
  65.           
  66.           of the FAT is valid, FIXFAT makes similar checks to those performed by
  67.           CHKDSK, except that "orphan clusters" (chains of clusters with no
  68.           corresponding directory entries) are not flagged as problems. The
  69.           occasional appearance of orphan clusters was rather common under
  70.           versions of DOS prior to 3.0, usually following a program abort, and
  71.           these are still not (usually) evidence of major trouble.
  72.  
  73.  
  74.                                LIMITATIONS AND RESTRICTIONS                               ____________________________
  75.  
  76.           FIXFAT uses the DOS disk interrupts (INT 25 and 26) to access the disk
  77.           - the program will not run on hardware/software combinations that do
  78.           not support the use of these interrupts (this is almost never a
  79.           problem). The program will, however, not run in the DOS compatibility                                               ___                             
  80.           box under OS/2. FIXFAT requires an amount of free memory (over and
  81.           above that which it uses for its own code) that is equal to at least
  82.           four times the size of the FAT on the target device. For most devices,
  83.           512 kB should be more than enough, but a device whose size pushes DOS
  84.           4.0's limits may be more than the program can handle.
  85.  
  86.  
  87.                                   ADDITIONAL INFORMATION                                  ______________________
  88.  
  89.           Like all well-behaved programs (!), FIXFAT signals successful
  90.           completion by returning to DOS with the ERRORLEVEL variable set to
  91.           zero. Different small positive values are returned for various errors.
  92.  
  93.           Comments, suggestions, etc. may be addressed to the author at:
  94.  
  95.                    1515 West Montgomery Avenue
  96.                    Rosemont
  97.                    PA 19010
  98.                    U.S.A.
  99.  
  100.           Please enclose a s.a.e. if you would like to receive a reply to a
  101.           question or a response to a comment.
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.           
  124.           
  125.                                           Page 2 
  126.